home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / race200.zip / README!.NOW < prev    next >
Text File  |  1993-02-27  |  15KB  |  310 lines
  1.                                                     
  2.  ┌───────────────────────────────────────────────────────────────────────────┐
  3.  │                                                                           │
  4.  │               ┌───────────┐         ┌───────────┐                         │
  5.  │               │▒▒▒▒▒▒▒▒▒▒ ├─────────┴┐▒▒▒▒▒▒▒▒▒ ├──────────┐              │
  6.  │               │▒▒┌────┐▒▒ │▒▒▒▒▒▒▒▒▒ │▒▒┌──────┬┘▒▒▒▒▒▒▒▒▒ │              │
  7.  │               │▒▒└────┘▒┌─┘▒┌─────┐▒ │▒▒│      │ ▒▒┌───────┘              │
  8.  │               │▒▒▒▒▒▒▒▒▒└─┐▒└─────┘▒ │▒▒│      │ ▒▒└─────┐                │
  9.  │               │▒▒▒┌───┐▒▒ │▒▒▒▒▒▒▒▒▒ │▒▒│      │ ▒▒▒▒▒▒▒ │                │
  10.  │               │▒▒▒│   │▒▒ │▒▒┌───┐▒▒ │▒▒└──────┴┐▒▒┌─────┘                │
  11.  │               │▒▒▒│   │▒▒ │▒▒│   │▒▒ │▒▒▒▒▒▒▒▒▒ │▒▒└───────┐              │
  12.  │               └───┘   └──┬┘▒▒│   │▒▒ ├─────────┬┘▒▒▒▒▒▒▒▒▒ │              │
  13.  │                          └───┘   └───┘         └───────────┘              │
  14.  │                                                                           │
  15.  │                                                                           │
  16.  │                 RACE v2.00 - RemoteAccess Caller Editor                   │
  17.  │        Copyright Michael F. Janke 1989,1993.  All Rights Reserved.        │
  18.  │                                                                           │
  19.  └───────────────────────────────────────────────────────────────────────────┘
  20.  
  21.  
  22. Due to a severe bout of procrastination, the RACE documentation was not
  23. ready in time for the RA 2.0 release.
  24.  
  25. Rather than hold up RACE, I felt it would be best to release it without
  26. documentation and follow up a short time later with proper documentation.
  27.  
  28. RACE is not that difficult to use, even without documentation, and many
  29. are veteran RACE users and would probably prefer to have a version that
  30. works with RA 2.0 than have to wait for docs.
  31.  
  32. Note that the info contained in this file is everything that is new
  33. since version 1.52.  To get it done as quickly as possible, bug fixes
  34. are not listed.  If you have been using the 1.60x beta versions of RACE,
  35. much of this info will be a repeat of what you already know.
  36.  
  37.  
  38. CONFIGURING RACE FOR RA 2.0
  39. ---------------------------
  40.  
  41. There are almost no configuration changes required.  You can put the new
  42. RACE executable files over your old version and RACE 2.00 will use your
  43. current RACE.CFG with no difficulty.   There are a few changes in
  44. RACECFG.EXE, but only in the removal of one miscellaneous configuration
  45. item and in the addition of the new user fields for report templates.
  46.  
  47. Hiding the user password is no longer an option in RACECFG because RACE
  48. does not display (and cannot display) a user password.  RA no longer
  49. stores a text password in the user file.  Only a 32-bit CRC of the
  50. password is retained and this number would have little meaning to a user
  51. of RACE.  Neither RA's RAMGR or RACE allow editing of the password field.
  52. You may only enter a NEW password.
  53.  
  54. Make sure you have deleted the RA 1.11 USERON.BBS file.  I'm sure the RA
  55. upgrade instruction will say the same thing, but in case you miss it...
  56.  
  57.  
  58. WHATS NEW IN RACE 2.00
  59. ----------------------
  60.  
  61.     Registration
  62.     ------------
  63.     As of March 1, 1993, the licensing fee for RACE has gone up to $15
  64.     and now includes the registration of eRACEm.  Neither program is
  65.     available separately and you are required to pay the $15
  66.     registration fee even if you only use one of the two programs.
  67.  
  68.     New Fields
  69.     ----------
  70.     All new fields in RA v2.0 are supported in RACE 2.00.  Most need no
  71.     explanation and will get none.  Refer to the RA docs if you're not
  72.     sure what a field represents.
  73.  
  74.     RACE has one extra field that is in the RA 2.0 structures but does
  75.     not appear to be used by RA 2.0 at this time.  RA calls this the
  76.     "Organisation" field.  RACE calls it the "Company" field and I have
  77.     made it available in RACE.  The only way data will get there at this
  78.     time is if YOU manually put it there.  Whether or not RA will use
  79.     this field in the future is unknown.
  80.     
  81.     The field RA calls SEX is called GENDER in RACE.  The GENDER field
  82.     is changed by entering E)dit mode, cursoring over to the field and
  83.     then using the spacebar, plus or minus keys to toggle to the desired
  84.     setting (unknown, male, female).
  85.  
  86.     Field Movement
  87.     --------------
  88.     RACE now allows moving about the user record in any direction while
  89.     in edit mode.  The <TAB> key will move to the field on the right.
  90.     <SHIFT-TAB> will move to the left.  The arrow keys will move up and
  91.     down as always.
  92.  
  93.     Date fields
  94.     -----------
  95.     Proper date format is now (once again) forced.  You may only enter
  96.     the date in MM-DD-YY format and an invalid date will not allow you
  97.     to leave the field until you correct it.  The jury is still out on
  98.     this one.  Some will like it, others will hate it.  I personally
  99.     haven't decided either way.  Whatever the majority wants is ok by
  100.     me.
  101.        
  102.     User Passwords
  103.     --------------
  104.     As mentioned previously, RA no longer stores the user password in
  105.     the user file.  This is for security purposes.  RACE no longer
  106.     displays a password field in a user record.  To give a user a
  107.     password, press <CTRL-P>.  You will be prompted for a =NEW=
  108.     password.  If a user forgets his/her password, he/she is out of luck
  109.     and will have to provide you with a new one for entry in their
  110.     record.
  111.  
  112.     Hot keys for attributes
  113.     -----------------------
  114.     They're gone.  The ALT-keys are no longer used to toggle attributes.
  115.     RACE now refers to these attributes as TOGGLES. These keys have been
  116.     replaced by ALT-T to pop up a window in which you may edit whichever
  117.     toggle you wish.  Do not mourn the loss of the ALT-D key to delete a
  118.     user.  Your <DEL> key performs the same function and it has been
  119.     there all along.
  120.  
  121.     Mailing list
  122.     ------------
  123.     RACE has a SUPER SIMPLE, ULTRA-NO FEATURE mailing label function
  124.     built in.  Pressing <CTRL-M> will cause RACE to create a file called
  125.     RACEMAIL.DAT in the current directory.  No prompt is provided, RACE
  126.     just goes right ahead and creates the file.  If it already exists,
  127.     it is overwritten.  This is a pure ascii file containing the
  128.     following fields:
  129.  
  130.     Username
  131.     Address1
  132.     Address2
  133.     Address3
  134.     Location
  135.  
  136.     Any capable word processor should be able to mangle this file into a
  137.     usable mailing list with which you can print labels.  Note that the
  138.     Address fields are only placed in the file if they contain data.
  139.  
  140.     Adding new users
  141.     ----------------
  142.     Adding a new user is now possible while another user is online.
  143.     Also, the new user takes various bits of info from the user record
  144.     that is currently on screen when you press <A> or <INS> to add a new
  145.     user.  You could create a 'template' user for this purpose or just
  146.     move to any user that has standard access before using the add
  147.     function.  DON'T FORGET to use <CTRL-P> after the new user record is
  148.     saved to install a password for the user.  If you don't do this, the
  149.     new user will have the password of the template user.  This is
  150.     useful in some situations but may be undesirable in others.
  151.  
  152.     Validation
  153.     ----------
  154.     User toggles are no longer displayed in validate nor are the hot
  155.     keys (Alt-keys) available to toggle the attributes.  As in the main
  156.     screen, ALT-T will bring up the toggle window.
  157.  
  158.     Templates will no longer LOWER the security level of a user.  If the
  159.     user already has a level higher than that provided by the template,
  160.     it will remain.
  161.  
  162.     Changed the acceptable input for the "Send predefined message" from
  163.     "Y/n" to "Y/n/i".  Previously, if you answered "n" to this prompt,
  164.     you were automatically prompted for "Text file to import."  This no
  165.     longer occurs.  If you wish to import a text file for the message
  166.     (other than the predefined message file), press "i" for import
  167.     instead of "n".
  168.  
  169.     Upgrading users with predefined templates is now possible from the
  170.     main screen without going into Validation. Press the number key
  171.     coinciding with the template you want applied to the user currently
  172.     on screen and the template prompt window will open up just as it
  173.     does in Validation.  At this point you may hit <enter> to apply that
  174.     template or type the rest of the number if it is more than one
  175.     digit.
  176.  
  177.     The number zero (0) has a special meaning.  If 0 is pressed, the
  178.     template list window will open up instead of the prompt window.
  179.     This will allow you to scroll through the list.  Once the
  180.     appropriate template is highlighted, hit <enter> to apply that
  181.     template to the current user.
  182.  
  183.     RACE now creates and constantly updates an index file for the answer
  184.     file.  This file will have the same filename as the answer file and
  185.     an extension of .IDX and it will be created in the RA system
  186.     directory.  There will be one .IDX file for each answer file you
  187.     view with validation.  Each record in the .IDX file (one for each
  188.     set of answers) consumes 9 bytes of disk space.
  189.  
  190.     Creation and updating of the index is done automatically.  RACE
  191.     parses the answer file and updates the index each time you go into
  192.     validation or when you <P>ick a new answer file from within
  193.     validation.
  194.  
  195.     RACE also does a simple test of the index before parsing.  RACE
  196.     reads the last index record and attempts to go to that position in
  197.     the answer file. If that position does not exist (such as when you
  198.     deleted the answer file but not the index) then RACE will rebuild
  199.     the index from the start.
  200.  
  201.     The above test will not account for all possible problems.  If, for
  202.     example, you manually edit answers out of the file then allow RA to
  203.     add new answers before ever running RACE, the test may past but the
  204.     last old entries in the index may not actually point to the start of
  205.     a set of answers.  If in doubt, delete the .IDX file and allow RACE
  206.     to rebuild it. It only takes a few seconds on average sized answer
  207.     files.
  208.  
  209.     This index file contains a 'last read' pointer so that RACE knows
  210.     where you left off on validating during your last use of CTRL-V type
  211.     validation.
  212.  
  213.     You may now allow your answer file to constantly grow and not have
  214.     to put up with RACE starting at the beginning each time you go into
  215.     validation.  Keep in mind that the 'last read' is wherever you were
  216.     when you quit last time not the highest record number you viewed.
  217.     If you jump to the first record then quit, RACE will start at the
  218.     first record on your next entry to validation.
  219.  
  220.     You now move forward AND backward through the answer file using the
  221.     right and left arrow keys.  You may also use HOME and END to jump to
  222.     the first and last set of answers respectively.  RACE no longer uses
  223.     <N>ext.
  224.  
  225.     Validation Mark Deleted
  226.     -----------------------
  227.     M)ark will allow you to toggle a set of user answers DELETED in
  228.     the index.  This will not affect the status of the user, only the
  229.     answers.  The answers will only be removed after running eRACEm with
  230.     the -A switch.  Note that this feature of eRACEm only works in the
  231.     registered version.
  232.  
  233.  
  234.     Validation FIND
  235.     ---------------
  236.     F)ind will still allow you to find other answers the currently
  237.     viewed user may have but you will now be prompted "Search Forward?".
  238.     <Y> or <ENTER> to this prompt will search forward otherwise hit <N>
  239.     to search backwards.  Once the search has begun AND answers are
  240.     found, you may move back and forth to the various answer sets of
  241.     that user by using the arrow keys.  Once you are at the last set of
  242.     answers for that user (in either direction), RACE reports no more
  243.     answers found and the find command is toggled off.
  244.  
  245.     Validation search
  246.     -----------------
  247.     S)earch will allow you to search for a specific user's answers.
  248.     Since RACE searches the index file for a CRC match and not the
  249.     answer file, it will only find EXACT matches.  Your input is
  250.     converted to uppercase and then a CRC is calculated on the name.
  251.     RACE then searches the index for a match. Because of this method,
  252.     partial names will never score a match since the CRC will never be
  253.     exactly the same.
  254.  
  255.     Validation Vip & Trash
  256.     ----------------------
  257.     V)ip and T)rash have been added.  These will insert the currently
  258.     viewed user name into the VIP.CTL or TRASHCAN.CTL file as the
  259.     command letter indicates.  Removing the user names from those files
  260.     is still done by the old manual method.
  261.  
  262.  
  263.     Validation Answer file
  264.     ----------------------
  265.     If you do not care to keep your answer file around, remove the index
  266.     file when you remove the answer file.  In other words, if you remove
  267.     the NEWUSER.ASW, also remove the NEWUSER.IDX file.  As mentioned
  268.     above, RACE attempts to handle invalid indexes but it is possible to
  269.     confuse it.
  270.  
  271.     The "Storage file" is no longer supported in RACE. Because of the
  272.     indexing method and RACE's ability to start where you left off, it
  273.     was felt that this was redundant.  The actual answer file may now be
  274.     used as storage. This makes it easy to review a particular user's
  275.     answers at any time while in RACE.
  276.  
  277.     Global C)hanges
  278.     --------------
  279.     New items have been added to the C)hanges menu. The items added are
  280.     DATE FORMAT, SUBSCRIPTION DATE and LANGUAGE.  Note that Language is
  281.     set by number and that's the input RACE expects.  It knows nothing
  282.     about what you have named language #1 or whatever.  So, you'll need
  283.     to know the number before going into RACE to make this change.  The
  284.     first language in your language list is #1 and so on.
  285.  
  286.     The entry window that permits setting the parameters for the changes
  287.     has one new item added: "Use Flags"
  288.  
  289.     When you get to this field, hit <ENTER> if you want to base the
  290.     global changes on flags (in addition to security, group, all/equal
  291.     to, etc.). When you hit <ENTER> a second window will open to allow
  292.     you to mark the flags RACE should examine to determine whether or
  293.     not to change the desired item in a user record.
  294.  
  295.     NOTE: RACE only makes a comparison for flags that are ON. For
  296.     example, you cannot make changes on users that have flag A8 OFF.
  297.  
  298.     Go into Use Flags field, hit <ENTER> then place an X in the
  299.     position(s) you want RACE to examine.  If the user has that/those
  300.     flags ON in his record AND all other parameters are met, the changes
  301.     will apply.  As with elsewhere in RACE, use CTRL-ENTER to save
  302.     changes and exit the flag entry screen.
  303.  
  304.  
  305.  
  306.                               <EOF>
  307.  
  308.  
  309.  
  310.